package com.example.springboot.controller;


import com.example.springboot.bean.User;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import io.swagger.annotations.ApiParam;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;

@Api(tags="用户模块 controller") //! 使用在 controller 类上,标记和描述一个控制层模块
@RestController
public class UserController {
    @ApiOperation("根据 id 获取用户信息") // 使用在方法上，标记和描述一个http 请求操作
    @GetMapping("/user/{id}")
    @ApiParam(name = "id", value = "用户 id", required = true)// 使用在方法上，标记和描述一个http 请求的入参
    public ResponseEntity<User> getUser(@PathVariable(value = "id") Integer id) {
        return new ResponseEntity<User>(User.builder().id(id).name("张三").build(),
                HttpStatus.OK);

    }
}